home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / logmngr.arc / LOGMNGR.DOC next >
Encoding:
Text File  |  1988-02-09  |  5.5 KB  |  90 lines
  1.                                                                                
  2.    LOGMNGR maintains a BBS (or other) log file. It is essentially a driver that
  3.    is called on a daily basis to perform the following:                         
  4.    
  5.        1) renames the log to prefix.DDD  (DDD is julian day)                   
  6.           Prefix is taken from the name of the log being processed. For 
  7.           example, if you are maintining the BINKLEY log, BINKLEY.LOG, the name 
  8.           generated will be BINKLEY.DDD.
  9.        2) add the days log to archive LOGmmmyy.ARC by calling Phil Katz' 
  10.           PKARC.COM program.  This must be in the DOS search path.  It is not 
  11.           included with this archive.
  12.        3) creates a new log with a time stamp                                  
  13.         
  14.        SYNTAX:
  15.  
  16.          LOGMNGR  configpathname                                                
  17.                                                                                
  18.         LOGMNGR was written to be used with Binkley, hence the defaults.       
  19.         There is no reason it can't be used for other things.  The config file  
  20.         used by LOGMNGR defaults to BINKLEY.CFG in the current directory or    
  21.         the path specified on the BINKLEY  environment parameter.  You can     
  22.         override this by specifying a fully qualified path and file name       
  23.         on the command line when you invoke LOGMNGR.  Some Examples:           
  24.                                                                                
  25.         COMMAND LINE                     RESULT                                
  26.                                                                                
  27.         LOGMNGR                          Uses BINKLEY.CFG from the current     
  28.                                          directory (if present) or from the    
  29.                                          path specified by the BINKLEY         
  30.                                          environment variable.  The BINKLEY    
  31.                                          variable must end in "\" if it is to  
  32.                                          be used.                              
  33.                                                                                
  34.                                                                                
  35.         LOGMNGR LOGMNGR.CFG              Uses LOGMNGR.CFG from the current     
  36.                                          directory as the config file          
  37.                                                                                
  38.         LOGMNGR \fred\BINKLEY.CFG        Uses BINKLEY.CFG from the directory   
  39.                                          \FRED\  as the CONFIG file.           
  40.                                                                                
  41.        LOGMNGR searches the config file for two control cards.  The first is a  
  42.        standard BINKLEY control card, "Statuslog". It is the name of the log   
  43.        file to be managed.  It is of the form: 
  44.                                           
  45. Statuslog logfilename                                                          
  46.                                                                                
  47.         Statuslog MUST begin in column one!                                    
  48.                                                                                
  49.         The second is a special LOGMNGR control card, ";LOGDIR"   
  50.         It must also begin in column one and must start with a semi-colon.     
  51.         This causes Binkley to treat it as a comment.  It specifies the         
  52.         directories to hold the archived logs.  It has the following format:
  53.  
  54. ;LOGDIR pathname                                                               
  55.         
  56.         It must also start in column 1.  In both cases there must be ONE AND 
  57.         ONLY ONE space between the operator (e.g. ";LOGDIR") and the operand 
  58.         (e.g. pathname).  
  59.  
  60.         The philosophy intended for LOGMNGR (at least the one the author       
  61.         uses) is that the day's log will be archived automatically once per    
  62.         day.  (I have an external BINKLEY event at midnight each day.)  This   
  63.         philosophy is reflected in the names that LOGMNGR generates for the    
  64.         logs and the archive that hold them.  They are noted above in the      
  65.         introduction.  Note that the archive BINyymmm.ARC will be placed in    
  66.         ;LOGDIR path if one is specified otherwise they will be in the current 
  67.         directory.  The new log file will be in the directory where the old    
  68.         one was found.                                                         
  69.  
  70.         LICENSE
  71.  
  72.         LOGMNGR is COPYRIGHT 1988 D. A. Freeman.  You are granted a limited 
  73.         license to use it for non-commercial purposes.  You are also welcome to 
  74.         distribute it in an unmodified fashion so long as no fee is charged.
  75.  
  76.         Comments and/or suggestions may be forwarded to the author at Fidonet 
  77.         node 223/128 (continuous mail) or to:
  78.  
  79.         D. A. Freeman
  80.         Freeman Software Services
  81.         P. O. Box 7430,
  82.         Oakville, Ontario
  83.         L6J 6L6
  84.  
  85.         If you find this program to be of use, please send a note of thanks to 
  86.         the author (netmail or post).  If you find it to be of value, you are 
  87.         requested to make a donation to a non-denominational charity dedicated 
  88.         to helping children or youths in the author's name. 
  89.  
  90.